home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1996 April / Software of the Month Club 1996 April.iso / pc / os2 / trashcan / trashcan.inf (.txt) < prev   
OS/2 Help File  |  1996-02-21  |  82KB  |  1,049 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Title Page ΓòÉΓòÉΓòÉ
  3.  
  4. Workplace Shell TrashCan 
  5. Version 2.3
  6.  
  7. (c) Kai Sommerfeld 1993-1995
  8.  
  9.  
  10. ΓòÉΓòÉΓòÉ 2. License Agreement ΓòÉΓòÉΓòÉ
  11.  
  12. Workplace Shell TrashCan is shareware. You are allowed to test and use this 
  13. program for 30 days. You must register TrashCan if you wish to continue using 
  14. it after 30 days. 
  15.  
  16. You may freely distribute the shareware version of TrashCan, but only the 
  17. complete and unaltered distribution archive. 
  18. You may install the registered version on more than one machine, but your copy 
  19. may be used on only one machine at a time.  If you run TrashCan on more than 
  20. one machine at a time, you must register additional licenses. 
  21. The author does not guarantee the correctness of the program. The author may 
  22. not be held responsible for any loss of data or other damages caused by the use 
  23. of TrashCan. The author does not guarantee that the program can be used for a 
  24. specific purpose. 
  25. If you wish to distribute the program in conjunction with commercial software 
  26. or hardware, you must have written permission of the author to do so. 
  27. A license is always a version license. It is valid for all versions of the 
  28. program that have the same major version number. You must acquire a new license 
  29. when upgrading to a new major version. 
  30. You are not allowed to give a registration key to third parties. 
  31.  
  32. A word to shareware: 
  33. Developing TrashCan has taken much of my spare time. Consequently, I decided to 
  34. release all new versions as shareware with some restrictions to encourage 
  35. registration. 
  36.  
  37. How to register: 
  38. Information on how to register and Order Forms can be found in the file 
  39. Register.TXT provided as part of WPS TrashCan's distribution archive. Simply 
  40. complete one of the order forms and send it to the appropriate address. Once I 
  41. have received the registration fee, you will get a unique registration number 
  42. used to remove the shareware restrictions from TrashCan. 
  43.  
  44. All users who sent me a postcard for any 1.x version of WPS TrashCan until 
  45. September 11, 1995 may get a free registration! Just notice me that you've sent 
  46. a postcard already and that you want to get a free registration. If I really 
  47. got your card, you will receive your registration information as soon as 
  48. possible. Thank you once again for supporting TrashCan! 
  49.  
  50. Shareware restrictions: 
  51. The unregistered version has a few restrictions that make TrashCan a little 
  52. less convenient, but allow you to evaluate all the features. After every system 
  53. reboot, the settings for user defined icons, capacity, and most trash options 
  54. will be reset to default values. Using DeskMan/2 to restore any of the settings 
  55. mentioned above is not possible. However, any Trashed objects will never be 
  56. deleted without confirmation in result of these restrictions. 
  57.  
  58.  
  59. ΓòÉΓòÉΓòÉ 3. Trademarks ΓòÉΓòÉΓòÉ
  60.  
  61. The following terms used in this book are trademarks of companies as follows. 
  62. Other trademarks are trademarks of their respective companies. 
  63.  
  64.  IBM                      International Business Machines Corporation 
  65.  OS/2                     International Business Machines Corporation 
  66.  System Object Model      International Business Machines Corporation 
  67.  Workplace Shell          International Business Machines Corporation 
  68.  MMPM/2                   International Business Machines Corporation 
  69.  Macintosh                Apple Computer, Inc. 
  70.  Lotus SmartCenter        Lotus Development Corporation 
  71.  OS/2 Essentials          Stardock Systems, Inc. (SDS) 
  72.  DeskMan/2                Development Technologies, Inc. (DevTech) 
  73.  
  74.  
  75. ΓòÉΓòÉΓòÉ 4. Introduction ΓòÉΓòÉΓòÉ
  76.  
  77. TrashCan is a replacement for the shredder object of OS/2 Warp Version 3 (or 
  78. higher). It brings a Macintosh-like trash can to your desktop. 
  79.  
  80. Unlike the shredder, TrashCan won't immediately delete objects dropped on it. 
  81. You can delete them yourself later, or configure TrashCan to delete them 
  82. according to options in it's settings notebook. So, you are able to recover 
  83. Trashed objects and get them back for normal use. 
  84.  
  85. TrashCan features: 
  86.  
  87.      Use of 3 different icons for easy detecting the current state of 
  88.       TrashCan. Icons can be replaced by your own favourite. 
  89.      Additional drag and drop features like 'Shred objects on drop' or 'Remove 
  90.       objects from LaunchPad'. 
  91.      Modified views providing information about Trashed objects, current size 
  92.       of trash, number of Trashed objcts, and more. 
  93.      Possiblity to restore Trashed objects to their original location. 
  94.      Destruction of objects which are generally not deletable. 
  95.      Capacity adjustable from 1 MByte to 'Unlimited'. 
  96.      Possibility to delete old Trashed objects automatically when exceeding 
  97.       the capacity set. 
  98.      You may select the drives to be supported by TrashCan. 
  99.      Interception of 'Delete' operations for ALL WPS objects. When activated, 
  100.       objects will not really be deleted but appear in TrashCan. 
  101.      Optional use of MMPM/2 system sounds when adding new objects, empty 
  102.       trash, etc. 
  103.      Interface to DeskMan/2 to backup and restore ALL the common and private 
  104.       settings of TrashCan. 
  105.  
  106.  What's different from 'Undelete' programs? 
  107.  
  108.  Only Workplace Shell sofware is able to deal with every object on your 
  109.  desktop. TrashCan not only handles files or directories but also recognizes 
  110.  other objects such as shadows, program objects, and color palettes, ... which 
  111.  are not represented by files on any storage media. 
  112.  
  113.  
  114. ΓòÉΓòÉΓòÉ 5. System Requirements ΓòÉΓòÉΓòÉ
  115.  
  116. To use Workplace Shell TrashCan you need OS/2 Warp Version 3 (or higher). It 
  117. will not run on previous versions of OS/2. 
  118.  
  119. Why this? 
  120.  
  121.    1. It is an application based on IBM's System Object Model Version 2 (SOM2), 
  122.       first introduced by Warp. 
  123.    2. It uses several methods, API calls, etc., which are new for Warp. 
  124.    3. The TrashCan library file is compressed using an algorithm unknown by 
  125.       OS/2 2.x. It cannot be loaded by operating system versions older than 
  126.       Warp. 
  127.  
  128.  It wasn't easy deciding not to support OS/2 2.x. But only Warp offers all the 
  129.  programming stuff I needed for TrashCan's sophisticated feature set. There was 
  130.  no other way, unfortunately. 
  131.  
  132.  
  133. ΓòÉΓòÉΓòÉ 6. Installation, Uninstallation And Update ΓòÉΓòÉΓòÉ
  134.  
  135. This section describes how to install, uninstall and update Workplace Shell 
  136. TrashCan. 
  137.  
  138. Important Note: Being a Workplace Shell class and not a 'normal' application, 
  139. TrashCan requires special installation and uninstallation procedures. Please 
  140. use the Installation Utility (InstUtil.EXE) only to peform these actions. 
  141.  
  142.  
  143. ΓòÉΓòÉΓòÉ 6.1. Installation ΓòÉΓòÉΓòÉ
  144.  
  145. Before you install Workplace Shell TrashCan make sure ALL files of the TrashCan 
  146. distribution package are located in the same directory. 
  147.  
  148. To install, follow the steps below: 
  149.  
  150.      Run InstUtil.EXE from the OS/2 Command Prompt or double-click the 
  151.       InstUtil.EXE icon. 
  152.      Adjust the installation path to where you want to keep the files related 
  153.       to WPS TrashCan. 
  154.      In the WPS objects field, type in the directory where you want to create 
  155.       the TrashCan object and the object for the on-line documentation. The 
  156.       default is your desktop. 
  157.      Push the Install button. 
  158.      All necessary files will now be copied to the selected destination, the 
  159.       class library will be registered to WPS and the new objects will be 
  160.       created. 
  161.      If requested to reboot, please do so. 
  162.  
  163.  
  164. ΓòÉΓòÉΓòÉ 6.2. Uninstallation ΓòÉΓòÉΓòÉ
  165.  
  166. To uninstall Workplace Shell TrashCan, do the following: 
  167.  
  168.      Run InstUtil.EXE from the OS/2 Command Prompt or double-click the 
  169.       InstUtil.EXE icon. 
  170.      The program automatically detects whether WPS TrashCan is already 
  171.       installed. 
  172.      Push the Uninstall button. 
  173.      All files installed along with TrashCan will be deleted now, the WPS 
  174.       classes related to TrashCan will be deregistered, and the appropriate 
  175.       objects will be destroyed. 
  176.      If confirmed, all entries for paths added to your config.sys during 
  177.       installation will be removed from this file. 
  178.  
  179.  Note: Hidden trash folders that may holding any Trashed objects at this time 
  180.  will not be touched by the uninstallation process, for data security reasons. 
  181.  
  182.  
  183. ΓòÉΓòÉΓòÉ 6.3. Update ΓòÉΓòÉΓòÉ
  184.  
  185. To update Workplace Shell TrashCan to another version, follow the steps below: 
  186.  
  187.      First uninstall the old version as described under Uninstallation. 
  188.      Install the new version like described under Installation. 
  189.  
  190.  Note: Your registration information will still be present after an update. 
  191.  
  192.  
  193. ΓòÉΓòÉΓòÉ 7. Using the TrashCan object ΓòÉΓòÉΓòÉ
  194.  
  195. This section describes basics of using the TrashCan object and gives an 
  196. overview of all of the new features it introduces. 
  197.  
  198.  
  199. ΓòÉΓòÉΓòÉ 7.1. Basics ΓòÉΓòÉΓòÉ
  200.  
  201. Working with the TrashCan object is similar to working with a 'normal' folder 
  202. object on your desktop. Any function of a folder that makes sense for a trash 
  203. can is available and will work as usual. 
  204.  
  205. Putting objects into TrashCan is as easy, just like a folder. Simply use your 
  206. mouse to drag any object over TrashCan's icon or one of it's open views and 
  207. drop it there. Recovering objects works also as usual. 
  208.  
  209. TrashCan offers a simple way of showing its current state by using different 
  210. icons. So there is no need to open it to see whether it has any Trashed objects 
  211. or not. 
  212.  
  213. There are three different states, represented by the following default icons: 
  214.  
  215.    1. TrashCan is empty. There is no object inside. 
  216.    2. TrashCan is not empty, but there is enough space for adding more trash. 
  217.    3. TrashCan is full. This means there is no space left to put new objects 
  218.       into. You must empty trash, shred one or more Trashed objects or increase 
  219.       TrashCan's capacity, if you want to put new objects inside. 
  220.  
  221.  But there is more... 
  222.  
  223.      You may make TrashCan behave like an advanced shredder and destroy 
  224.       objects immediately when dropping on. Just hold down the left mouse 
  225.       button in addition to the right one when dropping an object and TrashCan 
  226.       will delete it. 
  227.       Note: If you are using a left handed mouse or the left mouse button for 
  228.       dragging objects you have to press the right button. Just try it out! 
  229.  
  230.      You may remove objects from your LaunchPad or Smart Items from Lotus 
  231.       SmartCenter for OS/2 by simply dropping them on TrashCan. Note: Such 
  232.       objects will be destroyed immediately after drop and therefor never 
  233.       appear inside TrashCan. 
  234.  
  235.  
  236. ΓòÉΓòÉΓòÉ 7.2. Pop-up Menu Actions ΓòÉΓòÉΓòÉ
  237.  
  238. This will describe all the pop-up menu actions available for the TrashCan 
  239. object, except items that have no new functionality. 
  240.  
  241. A TrashCan object with it's typical pop-up menu opened is shown in the picture 
  242. below: 
  243.  
  244. The following pop-up menu items are added by TrashCan: 
  245.  
  246.  Empty                         Select this item to destroy all objects 
  247.                                currently held by TrashCan. If you activated 
  248.                                Confirm on trashcan empty in TrashCan's settings 
  249.                                notebook, you'll have to confirm this action 
  250.                                before it performs. Remember, TrashCan acts like 
  251.                                an advanced shredder when doing this. 
  252.  
  253.                                Note: This menu item is only available if there 
  254.                                are currently objects inside TrashCan. 
  255.  
  256.  Product information           This item can be found after selecting the arrow 
  257.                                to the right of Help. Usually it will be the 
  258.                                last item in the help menu. When selected, it 
  259.                                shows a dialog with information about version, 
  260.                                copyright, etc. of Workplace Shell TrashCan. 
  261.  
  262.  TrashCan also comes with new sort criteria for its contents. They are 
  263.  applicable after selecting the arrow to the right of the Sort menu item. This 
  264.  item is only available when one or more of TrashCan's views is opened: 
  265.  
  266.  Total Size                    Sorts TrashCan's contents by the disk space they 
  267.                                are using, beginning with the largest one. 
  268.  
  269.  Trash Date                    Sorts TrashCan's contents by the time they were 
  270.                                trashed, beginning with the oldest one. 
  271.  
  272.  Origin                        Sorts TrashCan's contents by the names of the 
  273.                                folders they came from, in alphabetical order. 
  274.  
  275.  
  276. ΓòÉΓòÉΓòÉ 7.3. Views ΓòÉΓòÉΓòÉ
  277.  
  278. Workplace Shell TrashCan does not provide any completely new views, but it 
  279. modifies the existing Icon view and Details view known from folder objects to 
  280. match the needs for a TrashCan object. 
  281.  
  282. In particular, it adds an area to the top of these views, which contains 
  283. information about how many objects are currently inserted and how much disk 
  284. space they are using. 
  285.  
  286. The pictures below show a typical Icon view and Details view of a TrashCan 
  287. object: 
  288.  
  289. In addition to the enhancements described above, the Details view of TrashCan 
  290. contains new information related to Trashed objects: 
  291.  
  292.  Total Size                    Information on how much disk space is used by a 
  293.                                Trashed object. 
  294.  
  295.                                Note: The size of trashed folders is calculated 
  296.                                accurately, which means that the real amount of 
  297.                                disk space that they and all contained objects 
  298.                                occupy will be reported. 
  299.  
  300.  Trash Date                    This is the date the object was trashed. 
  301.  
  302.  Trash Time                    The time the object was trashed. 
  303.  
  304.  Origin                        The name of the folder which contained the 
  305.                                object before trashing. This is the location for 
  306.                                recreating the object when performing a Restore. 
  307.  
  308.                                Note: This information may not be available in 
  309.                                some special cases - Refer to Reasons for 
  310.                                missing origin for additional information. 
  311.  
  312.  These new view items are customizable using the Details view settings notebook 
  313.  page of a TrashCan object. 
  314.  
  315.  
  316. ΓòÉΓòÉΓòÉ 7.4. Settings ΓòÉΓòÉΓòÉ
  317.  
  318. Workplace Shell TrashCan introduces new notebook pages to give you the 
  319. opportunity to customize it's behavior to your own needs. To adjust any of 
  320. TrashCan's settings use it's settings notebook as usual. 
  321.  
  322. Common to all new pages are the Undo, Default and Help buttons, which have the 
  323. same functionality here as they do in settings notebook pages of other WPS 
  324. objects. 
  325.  
  326. TrashCan also provides new criteria for sorting it's contents, customizable via 
  327. its Sort settings notebook page. 
  328.  
  329. The following section describes in detail all of the new pages and what they 
  330. are used for. 
  331.  
  332.  
  333. ΓòÉΓòÉΓòÉ 7.4.1. The 'Options' Notebook Page ΓòÉΓòÉΓòÉ
  334.  
  335. This notebook page is used to customize features for trash management, like the 
  336. capacity of TrashCan and confirmations. 
  337.  
  338. The picture below shows TrashCan's Options settings notebook page: 
  339.  
  340. The section Capacity is used to adjust settings related to the amount of trash 
  341. TrashCan will be able to hold. You may decide whether a limit of trash will be 
  342. used or not. 
  343.  
  344. Here is a detailed explanation of the available controls: 
  345.  
  346.  No limit                      Select this if you do not want a special 
  347.                                capacity. TrashCan will then keep as much trash 
  348.                                as possible. It stores Trashed objects as long 
  349.                                as space is left on storage media. 
  350.  
  351.  Limited to                    Select this if you want to set a limit for the 
  352.                                size of TrashCan. TrashCan will never execede 
  353.                                the capicty limit. 
  354.  
  355.                                Use the spin field to the right of this control 
  356.                                to adjust the capacity. Values from 1 MByte up 
  357.                                to the overall capacity of all currently 
  358.                                supported drives are selectable. 
  359.  
  360.  Auto delete                   This is used in conjunction with a limited 
  361.                                capacity only and therefore not selectable 
  362.                                unless Limited to is chosen. 
  363.  
  364.                                If selected, TrashCan will automatically delete 
  365.                                old Trashed objects as you trash new objects, if 
  366.                                the trash size grows over the specified 
  367.                                capacity. Old objects are destroyed depending on 
  368.                                their Trash Date and Trash Time information - 
  369.                                beginning with the oldest one, until there is 
  370.                                enough space for the new objects you want to 
  371.                                insert. 
  372.  
  373.                                This guaranties TrashCan will never be full and 
  374.                                you'll never have to empty trash yourself if you 
  375.                                don't want to do so. 
  376.  
  377.  Note: Trashing objects does not require additional disk space, but also it 
  378.  doesn't free any! Disk space is only freed if Trashed objects are destroyed. 
  379.  
  380.  The section Other is used to adjust any additional features. 
  381.  
  382.  The following controls are available: 
  383.  
  384.  Empty on system startup       If selected, trash will be emptied every time 
  385.                                the operating system is restarted. 
  386.  
  387.  'Delete' support              If activated, choosing Delete from the pop-up 
  388.                                menu of any object on your desktop will not 
  389.                                destroy this object but put it into TrashCan. 
  390.                                This also works if you press the Del key after 
  391.                                selecting an object (which generally would 
  392.                                destroy the object). 
  393.                                Note: This option only effects objects on 
  394.                                supported drives. Objects that not reside on a 
  395.                                supported drive will really be deleted. 
  396.  
  397.  Confirm on empty              You will have to confirm every time you empty 
  398.                                TrashCan, if you set a check mark here. 
  399.  
  400.  Confirm on auto delete        This is used in conjunction with Auto delete 
  401.                                (see above) only and will be ignored unless you 
  402.                                activated the auto delete feature. When this 
  403.                                option is selected, you'll have to confirm every 
  404.                                time TrashCan wants to destroy any old Trashed 
  405.                                objects by itself. Use this if you want to 
  406.                                prevent deleting of old objects which may still 
  407.                                be important to you. 
  408.  
  409.  
  410. ΓòÉΓòÉΓòÉ 7.4.2. The 'Drives' Notebook Page ΓòÉΓòÉΓòÉ
  411.  
  412. This notebook page is used to customize the drives to be supported by TrashCan. 
  413.  
  414. To use this feature properly, it is important to understand the following: 
  415.  
  416.    1. Where does TrashCan store the Trashed objects? 
  417.    2. What does it mean - support a drive? 
  418.  
  419.  The picture below shows TrashCan's Drives settings notebook page: 
  420.  
  421.  The following controls are available to customize the drives supported by 
  422.  TrashCan: 
  423.  
  424.  Available drives              This is a list of supportable, but currently not 
  425.                                supported drives. 
  426.  
  427.                                Note: Currently only drives located on 
  428.                                non-removable media (like hard disks) and to 
  429.                                which you have write access are supportable by 
  430.                                TrashCan. Removable drives and drives to which 
  431.                                you have read access only will not appear in 
  432.                                this list. 
  433.  
  434.  Supported drives              This is a list of all currently supported 
  435.                                drives. 
  436.  
  437.  Add >>                        This button is for adding a drive to the list of 
  438.                                supported drives. 
  439.  
  440.  << Remove                     Use this button to remove a drive from the list 
  441.                                of supported drives. 
  442.  
  443.  To add / remove support for a special drive, do the following: 
  444.  
  445.      Mark a drive in the list of available / supported drives. 
  446.      Push the Add >> / << Remove button or double-click the selected drive to 
  447.       perform. 
  448.  
  449.  Note: Hidden trash folders that may holding any Trashed objects at this time 
  450.  will not be touched when removing support for drives, for reasons of data 
  451.  security. 
  452.  
  453.  
  454. ΓòÉΓòÉΓòÉ 7.4.3. The 'Icons' Notebook Page ΓòÉΓòÉΓòÉ
  455.  
  456. This notebook page is used to customize the icons to be used by TrashCan to 
  457. show it's current state. 
  458.  
  459. The picture below shows TrashCan's Icons settings notebook page: 
  460.  
  461. Changing icons is done the same way as any other Workplace Shell object. The 
  462. Create another, Edit and Find buttons work as usual. Dropping any object on the 
  463. Current icon field to change an icon is also supported. 
  464.  
  465. Note: The controls for changing icons are generally located in the General page 
  466. of the settings notebook of a Workplace Shell object. Because TrashCan uses 3 
  467. icons, it's got it's own page for dealing with this. You will not find any 
  468. controls for manipulating icons on TrashCan's General page. 
  469.  
  470. To change an icon, do the following: 
  471.  
  472.      Select the icon you want to change by pushing the appropriate radio 
  473.       button in the Icons section of this page. 
  474.      You will see the icon currently assigned to the selected state in the 
  475.       Current icon field. 
  476.      Perform the action of changing the currently displayed icon like known 
  477.       from other WPS objects (for instance by using drag and drop). 
  478.  
  479.  
  480. ΓòÉΓòÉΓòÉ 7.5. System Sound ΓòÉΓòÉΓòÉ
  481.  
  482. Workplace Shell TrashCan introduces 2 new system sounds: 
  483.  
  484.  Empty trash                   This will be played every time you empty 
  485.                                TrashCan. 
  486.  
  487.  Drop trash                    You will hear this every time you put a new 
  488.                                object into TrashCan. 
  489.  
  490.  In addition, the predefined system sound Shred will be played every time 
  491.  objects located in TrashCan are destroyed. 
  492.  
  493.  Changing, enabling or disabling of the new or predefined sounds is done using 
  494.  the Sound object, located in your System Setup and Multimedia folder. 
  495.  
  496.  Note: The sound capabilities of TrashCan are only available if Base Multimedia 
  497.  Support (a part of MMPM/2) is installed on your system. This is a feature you 
  498.  may have chosen during installation of the operating system or after this 
  499.  using Selective Install. 
  500.  
  501.  
  502. ΓòÉΓòÉΓòÉ 7.6. Saving / Restoring Settings Using DeskMan/2 ΓòÉΓòÉΓòÉ
  503.  
  504. TrashCan provides an interface to the popular Workplace Shell backup utility 
  505. DeskMan/2. If you're a user of this software, refer to it's documentation for 
  506. further details. 
  507.  
  508. Calling the interface implemented in TrashCan, DeskMan/2 gets all information 
  509. about the private settings of a TrashCan object and is able to backup, update 
  510. and restore it completely. 
  511.  
  512. The following additional settings will be sent to DeskMan/2, when backing up a 
  513. TrashCan object: 
  514.  
  515.      The 3 icons used by TrashCan. 
  516.      The drives supported by TrashCan. 
  517.      TrashCan's capacity. 
  518.      Information about confirmations and all other user adjustable options for 
  519.       trash management. 
  520.  
  521.  
  522. ΓòÉΓòÉΓòÉ 8. Using Trashed Objects ΓòÉΓòÉΓòÉ
  523.  
  524. This section describes how to use Trashed objects and gives an overview of all 
  525. of it's features. 
  526.  
  527.  
  528. ΓòÉΓòÉΓòÉ 8.1. Basics ΓòÉΓòÉΓòÉ
  529.  
  530. What are Trashed objects? 
  531.  
  532. Trashed objects are objects that were 'deleted' by putting them into TrashCan. 
  533. Those objects can only be found inside a TrashCan object - they will not exist 
  534. anywhere else on your desktop. 
  535.  
  536. A Trashed object is a representative of a 'deleted' object. It offers special 
  537. functionality, very different from the object it's related to. 
  538.  
  539. Otherwise, being a Workplace Shell object, it's manipulated as usual. 
  540.  
  541.  
  542. ΓòÉΓòÉΓòÉ 8.2. Pop-up Menu Actions ΓòÉΓòÉΓòÉ
  543.  
  544. This will describe all the pop-up menu actions available for Trashed objects, 
  545. except items that have no new functionality. 
  546.  
  547. A Trashed object with its typical pop-up menu opened is shown in the picture 
  548. below: 
  549.  
  550. The following pop-up menu items are introduced or modified by Trashed objects: 
  551.  
  552.  Move...                       This works most similar to the normal Move, 
  553.                                except this action ends in recovering a Trashed 
  554.                                object in the destination folder you select. 
  555.  
  556.  Restore...                    Use this to recreate a Trashed object at the 
  557.                                location (the folder) it resided in before it 
  558.                                was trashed. On a successful restore, the folder 
  559.                                the object was recreated in will automatically 
  560.                                open to let you check the result. 
  561.  
  562.                                Note: This menu item may not be present if there 
  563.                                is no origin information available for a Trashed 
  564.                                object. 
  565.  
  566.  Shred                         Select this item to permanently destroy a 
  567.                                Trashed object. After this, the object can not 
  568.                                be recovered using TrashCan. Remember, TrashCan 
  569.                                acts like an advanced shredder when doing this. 
  570.  
  571.  Details...                    This item can be found after selecting the arrow 
  572.                                to the right of Open and shows the Trash Details 
  573.                                View of a Trashed object. 
  574.  
  575.  
  576. ΓòÉΓòÉΓòÉ 8.3. Views ΓòÉΓòÉΓòÉ
  577.  
  578. Trashed objects provide a new view called Trash Details. A typical Trash 
  579. Details view is shown in the picture below: 
  580.  
  581. The following information is available: 
  582.  
  583.  Object Class                  This is the title of the Workplace Shell class 
  584.                                the Trashed object belongs to. 
  585.  
  586.  Origin                        The name of the folder the Trashed object was 
  587.                                contained in before trashing. This is the place 
  588.                                for recreating the object, when performing a 
  589.                                Restore. 
  590.  
  591.                                Note: This information may not be available in 
  592.                                some special cases - Refer to Reasons for 
  593.                                missing origin for additional information. 
  594.  
  595.  Total Size                    Gives information on how many disk space is used 
  596.                                by a Trashed object. 
  597.  
  598.                                Note: The size of trashed folders is calculated 
  599.                                accurately. Which means the real amount of disk 
  600.                                space they and all contained objects occupy will 
  601.                                be reported - not just zero! 
  602.  
  603.  Time Stamp                    This is the date and time the object was 
  604.                                trashed. 
  605.  
  606.  
  607. ΓòÉΓòÉΓòÉ 8.4. Settings ΓòÉΓòÉΓòÉ
  608.  
  609. There are currently no settings available for customizing the behavior of 
  610. Trashed objects. 
  611.  
  612.  
  613. ΓòÉΓòÉΓòÉ 9. Frequently Asked Questions ΓòÉΓòÉΓòÉ
  614.  
  615. I have activated the 'Delete' support feature. But after selecting 'Delete' 
  616. from the pop-up menu of an object it will really be destroyed rather than 
  617. appearing in TrashCan (regardless it resides on a supported drive or not). 
  618.  
  619. Your TrashCan object may have lost its OBJECTID. When performing a delete the 
  620. WPS object searches a TrashCan object with an object id of <WP_TRASHCAN>. If no 
  621. such object can be found the delete operation will destroy the object. 
  622. Use one of the several tools available to reassign the correct object id to 
  623. TrashCan. 
  624.  
  625. To register my copy of WPS TrashCan I'm asked to open the 'Help' sub menu of 
  626. TrashCan's pop-up menu. But there is no menu item called 'Help'! 
  627.  
  628. Most possibly you have the statement SET MENUSTYLE=SHORT in your config.sys 
  629. file. This removes the Help item. To get it back, please comment the above 
  630. statement out and reboot. After that you will be able to register your copy. 
  631.  
  632.  
  633. ΓòÉΓòÉΓòÉ 10. Known Bugs / Limitations ΓòÉΓòÉΓòÉ
  634.  
  635.    1. TrashCan does not intercept delete operations done from 'outside' the 
  636.       WPS. If you delete files or directories using file manager programs or 
  637.       the Command Line, they will really be destroyed and therefor never appear 
  638.       in TrashCan! 
  639.  
  640.    2. Currently there is no handshake with or any other support for the DELDIR 
  641.       feature of OS/2. 
  642.  
  643.    3. TrashCan currently cannot remove broken items (those with a icon) from 
  644.       the LaunchPad. 
  645.  
  646.    4. When dragging objects out of TrashCan to another folder, the objects will 
  647.       not appear exactly at the drop position. I'm still working on this 
  648.       problem. 
  649.  
  650.    5. If you change any of the Format or Icon display settings in TrashCan's 
  651.       Icon view notebook page, and such a view is currently opened, the status 
  652.       area in the view will disappear. Closing and reopening the view will 
  653.       solve the problem. 
  654.  
  655.  
  656. ΓòÉΓòÉΓòÉ 11. Comments ΓòÉΓòÉΓòÉ
  657.  
  658. Workplace Shell TrashCan is still under development. It seems to run well on 
  659. the most systems, but there may be some bugs anyway! 
  660.  
  661. Being not a native english speaker I probably made mistakes. I'm always 
  662. interested in getting information on stylos left in WPS TrashCan's 
  663. documentation, in the online-help or in the program itself. 
  664.  
  665. If you are interested in translating TrashCan to your language, please contact 
  666. me. (You must have knowledge about the IPF Tag Language and  the Resource 
  667. Description Language to do the translation). Feel free to ask me whether there 
  668. is already available a version in your language. 
  669.  
  670.  
  671. ΓòÉΓòÉΓòÉ 12. Revision History ΓòÉΓòÉΓòÉ
  672.  
  673. The following is a list of all versions of Workplace Shell TrashCan, describing 
  674. the changes made over time: 
  675.  
  676. 01/07/94 - Version 1.0 (Initial release) 
  677.  
  678. 02/01/94 - Version 1.1 
  679.  
  680.    1. New Features: 
  681.  
  682.           User cutomizable icons for TrashCan. (Sounds simple - but believe 
  683.            me, it was a hard job!) 
  684.  
  685.    2. Bug Fixes: 
  686.  
  687.           Some fixes in 'undo' feature in the new notebook pages. 
  688.  
  689.    3. Other Changes: 
  690.  
  691.           n/a 
  692.  
  693.  02/18/94 - Version 1.2 
  694.  
  695.    1. New Features: 
  696.  
  697.           New default icons. (I've heard about any copyrights for the original 
  698.            Macintosh icons!) 
  699.           'auto delete on limit reach' mode. 
  700.  
  701.    2. Bug Fixes: 
  702.  
  703.           Drag and drop of large icon files (> 10K) caused an error. 
  704.  
  705.    3. Other Changes: 
  706.  
  707.           In 'Icons' notebook page: A frame is drawn around the icon displayed 
  708.            in 'Current icon' field while any WPS object is dragged over it. 
  709.  
  710.  02/26/94 - Version 1.3 
  711.  
  712.    1. New Features: 
  713.  
  714.           Added some sound to TrashCan ('Sound' notebook page). - Thanks to 
  715.            Robert Novitskey (Big Bad BoB) for the hint, how to do this! 
  716.  
  717.    2. Bug Fixes: 
  718.  
  719.           Dropping objects on TrashCan from other processes than the WPS (e.g. 
  720.            from FileManager/2) was not possible. (always stop sign when 
  721.            dragging over). 
  722.  
  723.    3. Other Changes: 
  724.  
  725.           If 'auto delete on limit reach' is active, and an object larger than 
  726.            the specified trash can capacity is put into the trash can, this 
  727.            object will be deleted immediately, instead of deleting first all 
  728.            old objects and then the new object too (result in  version 1.2 was 
  729.            an empty trash can). 
  730.           Validation check for TrashCan's capacity on installing, moving (to 
  731.            another drive) of the trash can folder. Now there will always be a 
  732.            valid capacity. 
  733.  
  734.  06/07/94 - Version 1.4 
  735.  
  736.    1. New Features: 
  737.  
  738.           Added a 'Change' button to 'Sound' notebook page, which opens the 
  739.            'Sound' notebook in the 'System Setup' folder. 
  740.           Added a 'Find ...' button to 'Icons' notebook page. Now searching 
  741.            works most similar to all other WPS objects. 
  742.           'Confirm on trash can empty' mode. 
  743.           The current trash size and the count of objects are now displayed in 
  744.            the icon view of TrashCan. 
  745.  
  746.    2. Bug Fixes: 
  747.  
  748.           Fixed a bug in 'install.exe' - If the old trashcan.dll and/or 
  749.            trashcan.hlp are/is set 'read only', a reinstallation/update failed. 
  750.           Changed a small "dirty" code fragment ( Ooops! ) - So this and 
  751.            coming versions of TrashCan will work fine with "OS/2 Performance 
  752.            Beta I" (and higher), too. 
  753.  
  754.    3. Other Changes: 
  755.  
  756.           'Empty' TrashCan and 'Shred' of object(s) via pop-up menu work now 
  757.            in a separate thread. So the WPS doesn't block while performing 
  758.            these tasks. 
  759.           Did some testing with TrashCan and OS/2 2.11 (OS/2 2.1 Service Pak: 
  760.            Syslevel XR06200) - found no problems. 
  761.  
  762.  11/22/94 - Version 1.5 (Only available with SDS OS/2 Essentials) 
  763.  
  764.    1. New Features: 
  765.  
  766.           During installation, now a location for the TrashCan object may be 
  767.            specified. If this location is different from the desktop folder, 
  768.            TrashCan automatically creates a shadow of itself on your desktop. 
  769.             Note: Creating the TrashCan folder in the root of boot drive is now 
  770.            the default! 
  771.           'Confirm on auto delete' mode. 
  772.           Added DeskMan/2 interface. DM/2 now may save all private settings of 
  773.            TrashCan, like the 3 icons or the trash options. So it can restore 
  774.            not only the data common to all WPS objects, but also those specific 
  775.            for TrashCan. 
  776.           If you want to change the icons of TrashCan via drag and drop, there 
  777.            is no longer a limitation to *.ico files! You may drop ANY objects 
  778.            on the 'Current icon' field in 'Icons' notebook page. 
  779.           The 'Icon' object is now preselected in find dialog, if you push the 
  780.            'Find ...' button in 'Icons' notebook page. 
  781.           The 'Sound' notebook page now only will be displayed, if you have 
  782.            installed MMPM/2 on your system. 
  783.  
  784.    2. Bug Fixes: 
  785.  
  786.           Some users reported problems when assigning 256 colored icons to 
  787.            TrashCan via drag and drop. I think, this bug is fixed now!? 
  788.  
  789.    3. Other Changes: 
  790.  
  791.           Minor (non functional) changes in drag/drop interface. 
  792.           The class dll file (TrashCan.DLL) no longer needs to be located in a 
  793.            path included in LIBPATH statement of config.sys. 
  794.           The Installer was completely redesigned. 
  795.           Did some testing with TrashCan and OS/2 Warp v3 (Syslevel XR03000) - 
  796.            no problems. 
  797.  
  798.  05/02/95 - Version 1.0 pro (Only available with SDS OS/2 Essentials) 
  799.  
  800.    1. New Features: 
  801.  
  802.           Shred objects on drop. 
  803.           Completely redesigned TrashCan's sound capabilities. There is no 
  804.            longer need for an own 'Sound' page in TrashCan's settings notebook. 
  805.            All the sound caps. are now controlled via the 'Sound' object coming 
  806.            with the operating system. 
  807.  
  808.    2. Bug Fixes: 
  809.  
  810.           n/a 
  811.  
  812.    3. Other Changes: 
  813.  
  814.           Made TrashCan more "Warp"-aware, esp. improved dealing with lazy 
  815.            drag and drop operations. 
  816.           'General' notebook page #2 (animation icon) now will be inserted 
  817.            behind the 'Icons' notebook page, instead behind the last 'File' 
  818.            page. 
  819.  
  820.  09/11/95 - Version 2.0 (Initial shareware release) / 2.0 pro 
  821.  
  822.    1. New Features: 
  823.  
  824.           Now TrashCan has it's own Details view with information about the 
  825.            Trashed objects. 
  826.           Trashed objects now have an own view which gives detailed 
  827.            information about them. 
  828.           You now may restore Trashed objects to the location they originally 
  829.            came from. 
  830.           Objects inserted into TrashCan now can be sorted by several 
  831.            criteria. 
  832.           Configuration of drives to support by TrashCan (New 'Drives' 
  833.            notebook page). 
  834.           Added XGA/8514 format to all icons. This is useful for users of 
  835.            display resolutions higher than 800x600 only (no longer ugly looking 
  836.            icons as a result of rendered VGA-format). 
  837.  
  838.    2. Bug Fixes: 
  839.  
  840.           Fixed a small bug accured when assigning an icon via drag and drop - 
  841.            If the dropped object is a data file, in some cases the wrong icon 
  842.            (that of the program object possibly associated with the data file) 
  843.            was assigned to TrashCan. 
  844.  
  845.    3. Other Changes: 
  846.  
  847.           Ported TrashCan to SOM2. 
  848.           Major rewrite of TrashCan for improved performance, memory usage and 
  849.            user comfort (only some visual changes but a lot of functional). 
  850.           Enhanced functionality to ensure the integrity of TrashCan's 
  851.            contents (for instance when deleting an object in a trash folder 
  852.            from the command line). 
  853.           There is no longer any reason for not creating the TrashCan object 
  854.            on the desktop - It now will be created there by default! The 
  855.            "Archive desktop" feature of Warp can be used without any problems 
  856.            now. 
  857.           Enhanced interface to DeskMan/2 (esp. for restoring / updating 
  858.            TrashCan via DeskMan/2). 
  859.           Minor changes in TrashCan's notebook page dialogs. 
  860.           'General' notebook page #2 (animation icon) was removed from 
  861.            TrashCan's settings notebook, because there is no need for this. 
  862.           Completely changed the way user defined icons will be saved, because 
  863.            of former problems when storing large icon data. 
  864.  
  865.  09/12/95 - Version 2.1 / 2.1 pro 
  866.  
  867.    1. New Features: 
  868.  
  869.           n/a 
  870.  
  871.    2. Bug Fixes: 
  872.  
  873.           Fixed a major bug (Arrgh!) in v2.0! Sometimes after reboot, there 
  874.            were duplicated Trashed objects in TrashCan! Means, when you opened 
  875.            a view of TrashCan, there possibly were multiple objects with the 
  876.            same name. Result was calculating of wrong total trash size and some 
  877.            strange things depending on this - Sorry for such an ugly bug - I 
  878.            hope, it's fixed now! 
  879.  
  880.    3. Other Changes: 
  881.  
  882.           Added file "SDS-OE.TXT" to distribution archive, which gives users 
  883.            of the commercial version of TrashCan information on how getting 
  884.            updates. 
  885.  
  886.  10/21/95 - Version 2.2 / 2.2 pro 
  887.  
  888.    1. New Features: 
  889.  
  890.           TrashCan now is able to remove objects from the LaunchPad and from 
  891.            "Lotus SmartCenter". However, broken LaunchPad items (? icon) are 
  892.            not supported in this version. 
  893.           You may now drop objects with opened views on TrashCan. All the 
  894.            views will be closed when trashing. However, currently TrashCan will 
  895.            not terminate any running apps! If you try to trash a running 
  896.            program, TrashCan refuses to do so. 
  897.  
  898.    2. Bug Fixes: 
  899.  
  900.           TrashCan didn't care about the default action for title clashes set 
  901.            in the 'System' object's 'Title' settings notebook page. When moving 
  902.            objects to TrashCan or when restoring Trashed objects to their 
  903.            original location, in case of title clashes, there always was 
  904.            displayed the prompt dialog. - Thanks to Gordy Thompson for 
  905.            reporting this bug. 
  906.           There were some bugs, caused by using DeskMan/2 to update / restore 
  907.            the TrashCan object: 
  908.              -  An animation icon was added to TrashCan - even, if there was 
  909.                 never assigned one. When opening any of TrashCan's views after 
  910.                 that, it's icon changed to that animation icon. For instance, 
  911.                 the bulged out icon changed to the slim one. TrashCan now 
  912.                 prevents such an assignment. 
  913.              -  TrashCan had the 'empty' icon assigned after performing an 
  914.                 update / restore, even it was not empty. 
  915.           Some other minor fixes. 
  916.  
  917.    3. Other Changes: 
  918.  
  919.           Performance improvement when dealing with large amount of Trashed 
  920.            objects. (Detecting any "Dirty Command Line Tricks" and adding / 
  921.            removing Trashed objects for any "Bad Boys" after that works MUCH 
  922.            faster now !) 
  923.           Removed the message boxes saying 'Object will be restored ...' and 
  924.            'Object restored successfully...' when a Restore was performed. I 
  925.            think, this gets somewhat nerving when restoring more than one 
  926.            object?! 
  927.           Documentation was completely rewritten. The on-line book 'Workplace 
  928.            Shell TrashCan - User's Guide' has replaced the ASCII file 
  929.            'TrashCan.DOC'. 
  930.           The installer was - once again - completely reworked: 
  931.              a. There is no longer need for the file 'InstUtil.CFG'. 
  932.              b. The new on-line documentation will be installed along with the 
  933.                 TrashCan class. 
  934.              c. Updating TrashCan is easier now. New versions may be installed 
  935.                 without rebooting after uninstallation. 
  936.              d. The installer handles all necessary changes to config.sys. 
  937.              e. Uninstall will generally delete all the old files installed 
  938.                 along with TrashCan and the installation directory, too. 
  939.  
  940.  11/04/95 - Version 2.3 / 2.3 pro 
  941.  
  942.    1. New Features: 
  943.  
  944.           Added 'TrashCan - support' for all WPS objects. If you delete any 
  945.            WPS object (i.e. by selecting 'Delete' from it's context menu), it 
  946.            will not be destroyed but will appear in TrashCan. 
  947.  
  948.    2. Bug Fixes: 
  949.  
  950.           n/a 
  951.  
  952.    3. Other Changes: 
  953.  
  954.           Registering TrashCan from outside Germany is much easier now by 
  955.            using the service of BMT Micro. Refer to the file 'Register.TXT' for 
  956.            further details. 
  957.  
  958.  
  959. ΓòÉΓòÉΓòÉ 13. Contacting The Author ΓòÉΓòÉΓòÉ
  960.  
  961. You may contact the author using following addresses: 
  962.  
  963.  Mail:          Kai Sommerfeld 
  964.                 Hochschulstr. 48 07/08 
  965.                 01069 Dresden 
  966.                 GERMANY 
  967.  
  968.  E-mail:        ks1@irz.inf.tu-dresden.de 
  969.  
  970.  Please feel free to send any comments / suggestions / bug reports to me. 
  971.  
  972.  
  973. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  974.  
  975. If you put an object into TrashCan, it moves this object from it's original 
  976. location to a hidden folder named 'Trash', located in the root of the drive the 
  977. object is on. Then a reference to the object - a Trashed object - will be added 
  978. to TrashCan's contents. This guaranties an optimal performance, because moving 
  979. objects from just one directory to another on the same drive is very fast. 
  980.  
  981. You may find such a folder on every drive currently supported by TrashCan. 
  982.  
  983. Note: The hidden folders mentioned above will be created and deleted 
  984. dynamically. That is, if there is no trash on a special drive, no folder will 
  985. be present there. 
  986.  
  987.  
  988. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  989.  
  990. In case of the request to trash an object, TrashCan looks at whether this 
  991. object resides on a drive currently marked as supportable. If it is so, the 
  992. object will be stored, if not, it will be destroyed immediately. In the last 
  993. case you will get a notification and may decide to cancel the action or perform 
  994. the destruction. 
  995.  
  996.  
  997. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  998.  
  999. Under some circumstances, there is no origin information available for a 
  1000. Trashed object. This will happen very seldom, but is possible. 
  1001.  
  1002. Known conditions for missing origin information are: 
  1003.  
  1004.      You just removed support for a drive currently holding any trash. As 
  1005.       mentioned, the stored objects will not be destroyed. When you reenable 
  1006.       the support for this drive, the old objects stored there will reappear in 
  1007.       TrashCan, but without origin information. 
  1008.  
  1009.      You've updated TrashCan to another version or reinstalled it. If there 
  1010.       were any stored objects at this time, they will reappear, but the origin 
  1011.       information is missing. 
  1012.  
  1013.      You put objects directly into hidden Trash folders or the TrashCan folder 
  1014.       itself, for instance using the OS/2 Command Line (e.g. 'copy stuff.txt 
  1015.       e:\Trash' or 'copy stuff.exe d:\Desktop\TrashCan'). 
  1016.  
  1017.  
  1018. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1019.  
  1020. TrashCan tries to destroy any kind of objects, when requested to do so. This 
  1021. means, it also deletes trash that is generally not deletable (like 
  1022. non-deletable templates, read-only files, ...). 
  1023.  
  1024.  
  1025. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1026.  
  1027. A commercial version of Workplace Shell TrashCan is shipped with "SDS OS/2 
  1028. Essentials" by Stardock Systems, Inc.. 
  1029.  
  1030.  
  1031. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1032.  
  1033. The Workplace Shell TrashCan distribution package contains the following files: 
  1034.  
  1035.  InstUtil.EXE        Program for installing, uninstalling and updating WPS 
  1036.                      TrashCan. 
  1037.  TrashCan.DLL        WPS class library containing TrashCan's whole 
  1038.                      functionality. 
  1039.  ObjPlus.DLL         WPS class library containing 'TrashCan support' for all 
  1040.                      WPS objects. 
  1041.  TrashCan.HLP        TrashCan's on-line help. 
  1042.  TrashCan.INF        TrashCan's on-line book (you are reading now). 
  1043.  ReadMe.1st          Basic information (ASCII file). 
  1044.  Register.TXT        Information related to registration and order forms (ASCII 
  1045.                      file). 
  1046.  SDS-OE.TXT          ASCII file containing information for users of the version 
  1047.                      of WPS TrashCan shipped with 'SDS OS/2 Essentials'. 
  1048.  FILE_ID.DIZ         Short description of WPS TrashCan for BBS sysops. 
  1049.